Amazon Pay

Amazon Pay随時弊社お支払い画面の利用について

アドレス帳ウィジェット・お支払い方法ウィジェットについて、
加盟店様は実装せずに弊社が提供している画面をご利用いただくことも可能です。
こちらを利用する場合は画面遷移やAPIが変わりますので、以下を参照の上、実装してください。

Amazon Payの画面遷移イメージ

初回決済時の画面遷移のイメージを以下に記載します。
弊社画面に遷移してAmazonログイン後（既にAmazonログインしている場合は省略可）、アドレス帳ウィジェット・お支払い方法ウィジェットを選択、お支払い方法設定同意ウィジェットにチェックを付け、決済を行います。
※2回目以降の決済は、これらの画面遷移を省略して決済することができます。

取引状態遷移

各操作を行った際の取引状態の遷移です。
「－」は、該当する結果、もしくは操作がないことを表しています。

操作 操作結果 操作前の状態 操作後の状態
取引登録 － － 未決済
決済実行（初回） 成功 未決済 要求成功
失敗 未決済
決済実行（2回目以降） 成功 未決済 仮売上／即時売上受付／即時売上
失敗 決済失敗
支払手続き開始IFの呼び出し 成功 要求成功 認証処理中
失敗 要求成功
お客様がお支払い方法選択画面で支払方法、住所を選択し決済 成功 認証処理中 仮売上／即時売上受付／即時売上
失敗 決済失敗
お客様がお支払い方法選択画面で決済をキャンセル 成功
 決済失敗
失敗 認証処理中
実売上 成功 仮売上 実売上／売上受付
失敗 仮売上
キャンセル 成功 仮売上／実売上／即時売上 キャンセル／返品／返品受付
失敗 仮売上／実売上／即時売上
(キャンセル実施前の状態)
キャンセル（一部返金） 成功 実売上／即時売上 実売上／即時売上／返品／返品受付
失敗 実売上／即時売上
当サービスによるAmazon Payとの同期処理（※1） － 即時売上受付／売上受付／返品受付 即時売上／実売上／返品

（※1）Amazon Payでの処理が非同期のため、即時売上受付／売上受付の状態遷移には1分～30分ほど、返品受付の状態遷移には1時間～3時間ほどかかります。
操作結果の取得は結果通知プログラム、または取引状態参照、弊社管理画面をご利用ください。

処理概要

決済の流れ

初回決済時

初回決済時の決済の流れを以下に記載します。
Amazon Payのログイン処理、及びアドレス帳ウィジェット・お支払い方法ウィジット・お支払い方法設定同意ウィジェットの表示を弊社にて行います。

sequenceDiagram お客様->>加盟店様: カート画面に進む
（購入処理開始） 加盟店様-->>お客様: カート画面表示 お客様->>加盟店様: 1.カート画面より
決済手続きに進む 加盟店様->>弊社: 2.取引登録 弊社-->>加盟店様:   加盟店様->>弊社: 3.決済実行 弊社-->>加盟店様:   加盟店様-->>お客様: 4.支払手続き開始IFに誘導 弊社-->>加盟店様: 結果通知（3.決済実行） お客様->>弊社: 5.支払手続き開始IF 弊社-->>お客様: Amazonpayボタン画面表示 お客様->>Amazon: 6.Amazonpayボタン押下 Amazon-->>お客様: Amazonログイン画面表示 Note right of Amazon: Amazonログイン済の場合は省略 お客様->>Amazon: 7.Amazonログイン Amazon-->>お客様:   お客様->>弊社:   弊社-->>お客様: 8.支払い方法選択画面表示 お客様->>弊社: 9.支払い方法、住所を選択、同意にチェックし決済を行う 弊社->>Amazon: 10.決済処理 Amazon-->>弊社:   Amazon-->>お客様: お客様宛てご利用通知メール送信 弊社-->>加盟店様: 結果通知（10.決済処理） 弊社-->>お客様: 加盟店様サイト（決済結果戻しURL）にリダイレクト お客様->>加盟店様: 11.決済結果受信 加盟店様-->>お客様: 画面表示

フローの説明

  1. お客様がお支払い手段にAmazon Payを選択します。
  2. 加盟店様は当サービスの[取引登録]を行います。
  3. 加盟店様は当サービスの[決済実行]を行います。
  4. 加盟店様はお客様を当サービスの[支払手続き開始IF]に誘導します。
  5. お客様のブラウザ上から当サービスの[支払手続き開始IF]が行われ、当サービスがAmazonボタン画面を表示します。
  6. お客様がAmazonログインボタンを押下します。
  7. お客様がAmazonサイトでログインします。
  8. 当サービスがお支払方法選択画面を表示します。
  9. お客様がウィジェットから決済に使用するクレジットカード・住所を選択、同意のチェックを付け、決済を行います。
  10. 当サービスがAmazon Payに対して決済処理を行います。
  11. 当サービスが加盟店様の決済結果戻しURLに決済結果を返却します。

2回目以降の決済時

2回目以降の決済の流れを以下に記載します。

sequenceDiagram participant お客様 加盟店様->>弊社: 1.取引登録 弊社-->>加盟店様:   加盟店様->>弊社: 2.決済実行 弊社->>Amazon: 3.決済処理 Amazon-->>弊社:   弊社-->>加盟店様: 結果通知（3.決済処理） 弊社-->>加盟店様: 4.結果返却

フローの説明

  1. 加盟店様は当サービスの[取引登録]を行います。
  2. 加盟店様は初回決済時に発行されたAmazonビリングアグリーメントIDを指定し、当サービスの[決済実行]を行います。
  3. 当サービスがAmazon Payに対して決済処理を行います。
  4. 当サービスが加盟店様に決済結果を返却します。
補足事項

・弊社お支払い方法選択画面を利用する場合、Amazonセラーセントラルの「JavaScriptの種類」及び「リダイレクトURL」には以下を追加してください。

項目名 説明
JavaScriptの種類 https://(弊社ドメイン)/
リダイレクトURL https://(弊社ドメイン)/payment/AmazonpayWidgetAutoPay.idPass
インタフェース仕様(プロトコルタイプ)

EntryTranAmazonpay 取引登録

これ以降の決済取引で必要となる取引IDと取引パスワードの発行を行い、取引を開始します。

リクエスト
ShopID shopID 必須 半角英数13桁
ショップID
ShopPass shopPass 必須 半角英数64桁
ショップパスワード
OrderID orderID 必須 半角英数記号27桁
オーダーID

加盟店様が取引を識別するための値を設定します。

JobCd jobCd 必須 半角英字7桁
処理区分

AUTH：仮売上
CAPTURE：即時売上
Amount amount 必須 半角数字7桁
利用金額

Tax tax 半角数字7桁
税送料

税送料を指定した場合は、利用金額 + 税送料が決済金額となります。
AmazonpayType amazonpayType 必須 半角数字1桁
AmazonPay実装タイプ

「2」を設定してください。

PaymentType paymentType 半角数字1桁
決済タイプ

「1」を設定してください。

URL
/payment/EntryTranAmazonpay.json
リクエストパラメータ
{
    "shopID":"tshop11223344",
    "shopPass":"PASSWORD",
    "orderID":"ORDER0000001",
    "jobCd":"AUTH",
    "amount":"1000",
    "amazonpayType":"2",
    "paymentType":"1"
}
URL
/payment/EntryTranAmazonpay.idPass
リクエストパラメータ
ShopID=tshop11223344&ShopPass=PASSWORD&OrderID=ORDER0000001&JobCd=AUTH&Amount=1000&AmazonpayType=2&PaymentType=1
レスポンス
正常
AccessID accessID 半角英数32桁 固定
取引ID

発行したIDを返却します。
※：同一オーダーIDでも決済手段が異なると、異なった「取引ID」および「取引パスワード」が返却されます。

AccessPass accessPass 半角英数32桁 固定
取引パスワード

発行したパスワードを返却します。
※：同一オーダーIDでも決済手段が異なると、異なった「取引ID」および「取引パスワード」が返却されます。

異常
ErrCode errCode 半角英数3桁 固定
エラーコード
ErrInfo errInfo 半角英数9桁 固定
エラー詳細コード
レスポンスパラメータ：正常系
{
    "accessID": "a6a6b0061347e90cdef806b39bd28705",
    "accessPass": "5e0e54b892e14ed03e8cf807a6053813"
}
レスポンスパラメータ：正常系
AccessID=a6a6b0061347e90cdef806b39bd28705&AccessPass=5e0e54b892e14ed03e8cf807a6053813
レスポンスパラメータ：異常系
[
    {
        "errCode":"E01",
        "errInfo":"E01040001"
    }
]
レスポンスパラメータ：異常系
ErrCode=E01&ErrInfo=E01040001

ExecTranAmazonpay 決済実行（初回決済時）

これ以降の決済取引で必要となるトークンを返却します。

リクエスト
ShopID shopID 必須 半角英数13桁
ショップID
ShopPass shopPass 必須 半角英数64桁
ショップパスワード
AccessID accessID 必須 半角英数32桁 固定
取引ID

【取引登録】で発行された値を設定します。

AccessPass accessPass 必須 半角英数32桁 固定
取引パスワード

【取引登録】で発行された値を設定します。

OrderID orderID 必須 半角英数記号27桁
オーダーID

【取引登録】で指定した値を設定します。

ClientField1 clientField1 全半角100バイト
加盟店自由項目1
ClientField2 clientField2 全半角100バイト
加盟店自由項目2
ClientField3 clientField3 全半角100バイト
加盟店自由項目3
RetURL retURL 必須 半角英数記号256桁
決済結果戻しURL

加盟店様が当サービスからの決済結果を受信する為の結果受信URLを設定します。
弊社画面上でお客様が支払操作をキャンセルした場合や、当サービスにて決済処理を実行した場合に指定されたURLに結果をリダイレクト経由で送信されます。
PaymentTermSec paymentTermSec 半角数字5桁
支払開始期限秒

お客様が【決済実行】から【支払手続き開始】を呼び出すまでの期限です。
最大86,400秒（1日）
呼出パラメータが空の場合、120秒で処理されます。
ItemName itemName 全半角文字記号64桁
商品名

【支払手続き開始】で遷移する画面上に表示する商品名を設定します。

URL
/payment/ExecTranAmazonpay.json
リクエストパラメータ
{
    "shopID":"tshop11223344",
    "shopPass":"PASSWORD",
    "orderID":"ORDER0000001",
    "accessID":"a6a6b0061347e90cdef806b39bd28705",
    "accessPass":"5e0e54b892e14ed03e8cf807a6053813",
    "retURL":"https://example.com/receive"
}
URL
/payment/ExecTranAmazonpay.idPass
リクエストパラメータ
ShopID=tshop11223344&ShopPass=PASSWORD&AccessID=a6a6b0061347e90cdef806b39bd28705&AccessPass=5e0e54b892e14ed03e8cf807a6053813&OrderID=ORDER0000001&RetURL=https://example.com/receive
レスポンス
正常
AccessID accessID 半角英数32桁 固定
取引ID

【決済実行】呼出時に指定した値を返却します。
Token token 半角英数64桁 固定
トークン

アクセスIDのハッシュ値を返却します。
StartURL startURL 半角英数記号256桁
支払手続き開始のURL

支払手続き開始のURLを返却します。
StartLimitDate startLimitDate 半角数字14桁 固定
支払開始期限日時

支払手続き開始の呼び出し期限を返却します。
yyyyMMddHHmmss書式
異常
ErrCode errCode 半角英数3桁 固定
エラーコード
ErrInfo errInfo 半角英数9桁 固定
エラー詳細コード
レスポンスパラメータ：正常系
{
    "accessID":"84636abd0bb03500ffce1e1a78deb1b2",
    "token":"qlxcMlmNXu+YJoAPr0zIiHoG/KrcaJJkTVUEeuYe67E3Vh427rKZBJphG0D2YhAL",
    "startURL":"https://x01.mul-pay.jp/payment/AmazonpayStart.idPass",
    "startLimitDate":"20190225162711"
}
レスポンスパラメータ：正常系
AccessID=84636abd0bb03500ffce1e1a78deb1b2&Token=qlxcMlmNXu+YJoAPr0zIiHoG/KrcaJJkTVUEeuYe67E3Vh427rKZBJphG0D2YhAL&StartURL=https://x01.mul-pay.jp/payment/AmazonpayStart.idPass&StartLimitDate=20190225162711
レスポンスパラメータ：異常系
[
    {
        "errCode":"E01",
        "errInfo":"E01040001"
    }
]
レスポンスパラメータ：異常系
ErrCode=E01&ErrInfo=E01040001

AmazonpayStart 支払手続き開始

お客様の表示画面を弊社画面へリダイレクトします。

リクエスト
AccessID accessID 必須 半角英数32桁 固定
取引ID

【取引登録】で発行された値を設定します。
Token token 必須 半角英数64桁 固定
トークン

【決済実行】で発行された値を設定します。
AmazonAccessToken amazonAccessToken 半角英数字記号200桁
Amazonアクセストークン

加盟店様サイトで既にAmazonログインしている場合、ログイン後に発行されたaccess_tokenを設定します。
設定した場合、Amazonログイン画面をスキップして決済ウィジェット画面を表示します。

URL
/payment/AmazonpayStart.idPass
リダイレクトページサンプル

<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=Windows-31J">
  </head>
  <body OnLoad='OnLoadEvent();'>
    <form name="AmazonpayStartCall" action="{接続先URL}" method="POST">
      <noscript>
        <br>
        <br>
        <center>
          <h2>AmazonPayの決済画面へ遷移します。 </h2>
          <input type="submit" value="続行">
        </center>
      </noscript>
      <input type="hidden" name="AccessID" value="{AccessID}">
      <input type="hidden" name="Token" value="{Token}">
      <input type="hidden" name="AmazonAccessToken" value="{AmazonAccessToken}">
    </form>
    <script >
<!--
function OnLoadEvent() {
document.AmazonpayStartCall.submit();
}
//-->
</script>
  </body>
</html>

リダイレクト後、以下の画面を表示します。（入力パラメータにAmazonAccessTokenを設定した場合は当画面はスキップします。）
ボタンをクリックするとAmazonログイン画面に遷移します。

Amazonログイン画面を表示します。（入力パラメータにAmazonAccessTokenを設定した場合は当画面はスキップします。）
Amazonアカウントのメールアドレス、パスワードを入力しログインします。

ログインしたAmazonアカウントに登録されている住所情報、クレジットカード情報、及びお支払い方法設定同意ウィジェットを表示します。
弊社管理画面にて設定を変更することにより、住所情報は非表示にすることが可能です。
※詳細はAmazon Pay管理画面マニュアル を参照ください。

「購入する」をクリックすると決済を行います。
「中止する」をクリックすると対象取引は決済失敗となります。やり直す場合は別オーダーIDで再度【取引登録】から行ってください。

決済結果受信

当サービスは、お客様が支払操作を完了または中止した際に、決済実行時に指定された決済結果戻しURLに結果を通知します。
この決済結果は、決済ウィジェット画面からブラウザ経由で連携されるため、ユーザの操作方法によっては支払操作が完了したにもかかわらず、加盟店様に通知されないことがあります。
その際はショップ管理画面、結果通知、決済状態照会にてご確認ください。また、同様の理由でこの決済結果が複数回加盟店様に通知されることがあります。

レスポンス
正常
ShopID shopID 半角英数13桁
ショップID
OrderID orderID 半角英数記号27桁
オーダーID

対象取引のオーダーIDを返却します。
Status status
現状態

該当取引の取引状態を返却します。
・AUTH：仮売上
・REQCAPTURE：即時売上要求
・CAPTURE：即時売上
・PAYFAIL：決済失敗

TranDate tranDate 半角数字14桁 固定
処理日時

当サービスで処理を実施した日時を返却します。
yyyyMMddHHmmss書式

AmazonOrderReferenceID amazonOrderReferenceID 半角英数19桁
AmazonオーダーリファレンスID

Amazonで取引を特定するためのIDを返却します。

AmazonBillingAgreementID amazonBillingAgreementID 半角英数19桁
AmazonビリングアグリーメントID

Amazonで随時取引を行うためのIDを返却します。

CheckString checkString 半角英数32桁
改ざんチェック文字列

OrderID、AccessID、ShopID、ShopPassを連結しMD5ハッシュした値を返却します。
異常
ErrCode errCode 半角英数3桁 固定
エラーコード
ErrInfo errInfo 半角英数9桁 固定
エラー詳細コード

※画面リダイレクトのため、決済エラー以外はエラーコードは返却しません。

2回目以降の決済実行、及び、実売上、キャンセル、住所情報参照、取引状態参照のAPIについては通常の場合と変わりありません。